home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 19 / CU Amiga Magazine's Super CD-ROM 19 (1998)(EMAP Images)(GB)[!][issue 1998-02].iso / CUCD / Online / RFCs / rfc / rfc1473.txt < prev    next >
Text File  |  1994-11-01  |  21KB  |  563 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                      F. Kastenholz
  8. Request for Comments: 1473                            FTP Software, Inc.
  9.                                                                June 1993
  10.  
  11.  
  12.                  The Definitions of Managed Objects for
  13.                    the IP Network Control Protocol of
  14.                       the Point-to-Point Protocol
  15.  
  16. Status of this Memo
  17.  
  18.    This RFC specifies an IAB standards track protocol for the Internet
  19.    community, and requests discussion and suggestions for improvements.
  20.    Please refer to the current edition of the "IAB Official Protocol
  21.    Standards" for the standardization state and status of this protocol.
  22.    Distribution of this memo is unlimited.
  23.  
  24. Abstract
  25.  
  26.    This memo defines a portion of the Management Information Base (MIB)
  27.    for use with network management protocols in TCP/IP-based internets.
  28.    In particular, it describes managed objects used for managing the IP
  29.    Network Control Protocol on subnetwork interfaces using the family of
  30.    Point-to-Point Protocols [8, 9, 10, 11, & 12].
  31.  
  32. Table of Contents
  33.  
  34.    1. The Network Management Framework ......................    1
  35.    2. Objects ...............................................    2
  36.    2.1 Format of Definitions ................................    2
  37.    3. Overview ..............................................    2
  38.    3.1 Object Selection Criteria ............................    2
  39.    3.2 Structure of the PPP .................................    2
  40.    3.3 MIB Groups ...........................................    3
  41.    4. Definitions ...........................................    4
  42.    5. Acknowledgements ......................................    8
  43.    6. Security Considerations ...............................    8
  44.    7. References ............................................    8
  45.    8. Author's Address ......................................    9
  46.  
  47. 1.  The Network Management Framework
  48.  
  49.    The Internet-standard Network Management Framework consists of three
  50.    components.  They are:
  51.  
  52.       STD 16/RFC 1155 which defines the SMI, the mechanisms used for
  53.       describing and naming objects for the purpose of management.  STD
  54.       16/RFC 1212 defines a more concise description mechanism, which is
  55.  
  56.  
  57.  
  58. Kastenholz                                                      [Page 1]
  59.  
  60. RFC 1473                       PPP/IP MIB                      June 1993
  61.  
  62.  
  63.       wholly consistent with the SMI.
  64.  
  65.       STD 17/RFC 1213 which defines MIB-II, the core set of managed
  66.       objects for the Internet suite of protocols.
  67.  
  68.       STD 15/RFC 1157 which defines the SNMP, the protocol used for
  69.       network access to managed objects.
  70.  
  71.    The Framework permits new objects to be defined for the purpose of
  72.    experimentation and evaluation.
  73.  
  74. 2.  Objects
  75.  
  76.    Managed objects are accessed via a virtual information store, termed
  77.    the Management Information Base or MIB.  Objects in the MIB are
  78.    defined using the subset of Abstract Syntax Notation One (ASN.1) [3]
  79.    defined in the SMI.  In particular, each object type is named by an
  80.    OBJECT IDENTIFIER, an administratively assigned name.  The object
  81.    type together with an object instance serves to uniquely identify a
  82.    specific instantiation of the object.  For human convenience, we
  83.    often use a textual string, termed the descriptor, to refer to the
  84.    object type.
  85.  
  86. 2.1.  Format of Definitions
  87.  
  88.    Section 4 contains the specification of all object types contained in
  89.    this MIB module.  The object types are defined using the conventions
  90.    defined in the SMI, as amended by the extensions specified in [5,6].
  91.  
  92. 3.  Overview
  93.  
  94. 3.1.  Object Selection Criteria
  95.  
  96.    To be consistent with IAB directives and good engineering practice,
  97.    an explicit attempt was made to keep this MIB as simple as possible.
  98.    This was accomplished by applying the following criteria to objects
  99.    proposed for inclusion:
  100.  
  101.       (1)  Require objects be essential for either fault or
  102.            configuration management.  In particular, objects for
  103.            which the sole purpose was to debug implementations were
  104.            explicitly excluded from the MIB.
  105.  
  106.       (2)  Consider evidence of current use and/or utility.
  107.  
  108.       (3)  Limit the total number of objects.
  109.  
  110.       (4)  Exclude objects which are simply derivable from others in
  111.  
  112.  
  113.  
  114. Kastenholz                                                      [Page 2]
  115.  
  116. RFC 1473                       PPP/IP MIB                      June 1993
  117.  
  118.  
  119.            this or other MIBs.
  120.  
  121. 3.2.  Structure of the PPP
  122.  
  123.    This section describes the basic model of PPP used in developing the
  124.    PPP MIB. This information should be useful to the implementor in
  125.    understanding some of the basic design decisions of the MIB.
  126.  
  127.    The PPP is not one single protocol but a large family of protocols.
  128.    Each of these is, in itself, a fairly complex protocol.  The PPP
  129.    protocols may be divided into three rough categories:
  130.  
  131.    Control Protocols
  132.       The Control Protocols are used to control the operation of the
  133.       PPP. The Control Protocols include the Link Control Protocol
  134.       (LCP), the Password Authentication Protocol (PAP), the Link
  135.       Quality Report (LQR), and the Challenge Handshake Authentication
  136.       Protocol (CHAP).
  137.  
  138.    Network Protocols
  139.       The Network Protocols are used to move the network traffic over
  140.       the PPP interface.  A Network Protocol encapsulates the datagrams
  141.       of a specific higher-layer protocol that is using the PPP as a
  142.       data link.  Note that within the context of PPP, the term "Network
  143.       Protocol" does not imply an OSI Layer-3 protocol; for instance,
  144.       there is a Bridging network protocol.
  145.  
  146.    Network Control Protocols (NCPs)
  147.       The NCPs are used to control the operation of the Network
  148.       Protocols. Generally, each Network Protocol has its own Network
  149.       Control Protocol; thus, the IP Network Protocol has its IP Control
  150.       Protocol, the Bridging Network Protocol has its Bridging Network
  151.       Control Protocol and so on.
  152.  
  153.    This document specifies the objects used in managing one of these
  154.    protocols, namely the IP Network Control Protocol.
  155.  
  156. 3.3.  MIB Groups
  157.  
  158.    Objects in this MIB are arranged into several MIB groups.  Each group
  159.    is organized as a set of related objects.
  160.  
  161.    These groups are the basic unit of conformance: if the semantics of a
  162.    group are applicable to an implementation then all objects in the
  163.    group must be implemented.
  164.  
  165.    The PPP MIB is organized into several MIB Groups, including, but not
  166.    limited to, the following groups:
  167.  
  168.  
  169.  
  170. Kastenholz                                                      [Page 3]
  171.  
  172. RFC 1473                       PPP/IP MIB                      June 1993
  173.  
  174.  
  175.           o The PPP Link Group
  176.           o The PPP LQR Group
  177.           o The PPP LQR Extensions Group
  178.           o The PPP IP Group
  179.           o The PPP Bridge Group
  180.           o The PPP Security Group
  181.  
  182.    This document specifies the following group:
  183.  
  184.    The PPP IP Group
  185.       The PPP IP Group contains configuration, status, and control
  186.       variables that apply to the operation of IP over PPP.
  187.  
  188.       Implementation of this group is mandatory for all implementations
  189.       of PPP that support IP over PPP.
  190.  
  191. 4.  Definitions
  192.  
  193.           PPP-IP-NCP-MIB DEFINITIONS ::= BEGIN
  194.  
  195.           IMPORTS
  196.                Counter
  197.                     FROM RFC1155-SMI
  198.                ifIndex
  199.                     FROM RFC1213-MIB
  200.                OBJECT-TYPE
  201.                     FROM RFC-1212
  202.                ppp
  203.                     FROM PPP-LCP-MIB;
  204.  
  205.                -- The PPP IP Group.
  206.                -- Implementation of this group is mandatory for all
  207.                -- PPP implementations that support operating IP over PPP.
  208.  
  209.                pppIp OBJECT IDENTIFIER ::= { ppp 3 }
  210.  
  211.  
  212.           pppIpTable   OBJECT-TYPE
  213.                SYNTAX    SEQUENCE OF PppIpEntry
  214.                ACCESS    not-accessible
  215.                STATUS    mandatory
  216.                DESCRIPTION
  217.                          "Table containing the IP parameters and
  218.                          statistics for the local PPP entity."
  219.                ::= { pppIp 1 }
  220.  
  221.  
  222.           pppIpEntry   OBJECT-TYPE
  223.  
  224.  
  225.  
  226. Kastenholz                                                      [Page 4]
  227.  
  228. RFC 1473                       PPP/IP MIB                      June 1993
  229.  
  230.  
  231.                SYNTAX    PppIpEntry
  232.                ACCESS    not-accessible
  233.                STATUS    mandatory
  234.                DESCRIPTION
  235.                          "IPCP status information for a particular PPP
  236.                          link."
  237.                INDEX     { ifIndex }
  238.                ::= { pppIpTable 1 }
  239.  
  240.  
  241.           PppIpEntry ::= SEQUENCE {
  242.                pppIpOperStatus
  243.                     INTEGER,
  244.                pppIpLocalToRemoteCompressionProtocol
  245.                     INTEGER,
  246.                pppIpRemoteToLocalCompressionProtocol
  247.                     INTEGER,
  248.                pppIpRemoteMaxSlotId
  249.                     INTEGER,
  250.                pppIpLocalMaxSlotId
  251.                     INTEGER
  252.           }
  253.  
  254.           -- The following object reflect the values of the option
  255.           -- parameters used in the PPP IP Control Protocol
  256.           --   pppIpLocalToRemoteCompressionProtocol
  257.           --   pppIpRemoteToLocalCompressionProtocol
  258.           --   pppIpRemoteMaxSlotId
  259.           --   pppIpLocalMaxSlotId
  260.           -- These values are not available until after the PPP Option
  261.           -- negotiation has completed, which is indicated by the link
  262.           -- reaching the open state (i.e., pppIpOperStatus is set to
  263.           -- opened).
  264.           --
  265.           -- Therefore, when pppIpOperStatus is not opened
  266.           -- the contents of these objects is undefined. The value
  267.           -- returned when accessing the objects is an implementation
  268.           -- dependent issue.
  269.  
  270.  
  271.           pppIpOperStatus   OBJECT-TYPE
  272.                SYNTAX    INTEGER {opened(1), not-opened(2)}
  273.                ACCESS    read-only
  274.                STATUS    mandatory
  275.                DESCRIPTION
  276.                          "The operational status of the IP network
  277.                          protocol. If the value of this object is up
  278.                          then the finite state machine for the IP
  279.  
  280.  
  281.  
  282. Kastenholz                                                      [Page 5]
  283.  
  284. RFC 1473                       PPP/IP MIB                      June 1993
  285.  
  286.  
  287.                          network protocol has reached the Opened state."
  288.                ::= { pppIpEntry 1 }
  289.  
  290.  
  291.           pppIpLocalToRemoteCompressionProtocol   OBJECT-TYPE
  292.                SYNTAX    INTEGER {
  293.                          none(1),
  294.                          vj-tcp(2)
  295.                     }
  296.                ACCESS    read-only
  297.                STATUS    mandatory
  298.                DESCRIPTION
  299.                          "The IP compression protocol that the local
  300.                          PPP-IP entity uses when sending packets to the
  301.                          remote PPP-IP entity. The value of this object
  302.                          is meaningful only when the link has reached
  303.                          the open state (pppIpOperStatus is opened)."
  304.                ::= { pppIpEntry 2 }
  305.  
  306.  
  307.           pppIpRemoteToLocalCompressionProtocol   OBJECT-TYPE
  308.                SYNTAX    INTEGER {
  309.                          none(1),
  310.                          vj-tcp(2)
  311.                     }
  312.                ACCESS    read-only
  313.                STATUS    mandatory
  314.                DESCRIPTION
  315.                          "The IP compression protocol that the remote
  316.                          PPP-IP entity uses when sending packets to the
  317.                          local PPP-IP entity. The value of this object
  318.                          is meaningful only when the link has reached
  319.                          the open state (pppIpOperStatus is opened)."
  320.                ::= { pppIpEntry 3 }
  321.  
  322.  
  323.           pppIpRemoteMaxSlotId   OBJECT-TYPE
  324.                SYNTAX    INTEGER(0..255)
  325.                ACCESS    read-only
  326.                STATUS    mandatory
  327.                DESCRIPTION
  328.                          "The Max-Slot-Id parameter that the remote node
  329.                          has advertised and that is in use on the link.
  330.                          If vj-tcp header compression is not in use on
  331.                          the link then the value of this object shall be
  332.                          0. The value of this object is meaningful only
  333.                          when the link has reached the open state
  334.                          (pppIpOperStatus is opened)."
  335.  
  336.  
  337.  
  338. Kastenholz                                                      [Page 6]
  339.  
  340. RFC 1473                       PPP/IP MIB                      June 1993
  341.  
  342.  
  343.                ::= { pppIpEntry 4 }
  344.  
  345.  
  346.           pppIpLocalMaxSlotId   OBJECT-TYPE
  347.                SYNTAX    INTEGER(0..255)
  348.                ACCESS    read-only
  349.                STATUS    mandatory
  350.                DESCRIPTION
  351.                          "The Max-Slot-Id parameter that the local node
  352.                          has advertised and that is in use on the link.
  353.                          If vj-tcp header compression is not in use on
  354.                          the link then the value of this object shall be
  355.                          0. The value of this object is meaningful only
  356.                          when the link has reached the open state
  357.                          (pppIpOperStatus is opened)."
  358.                ::= { pppIpEntry 5 }
  359.  
  360.  
  361.           --
  362.           -- The PPP IP Configuration table.
  363.           -- This is a separate table in order to facilitate
  364.           -- placing these variables in a separate MIB view.
  365.           --
  366.  
  367.           pppIpConfigTable   OBJECT-TYPE
  368.                SYNTAX    SEQUENCE OF PppIpConfigEntry
  369.                ACCESS    not-accessible
  370.                STATUS    mandatory
  371.                DESCRIPTION
  372.                          "Table containing configuration variables for
  373.                          the IPCP for the local PPP entity."
  374.                ::= { pppIp 2 }
  375.  
  376.  
  377.           pppIpConfigEntry   OBJECT-TYPE
  378.                SYNTAX    PppIpConfigEntry
  379.                ACCESS    not-accessible
  380.                STATUS    mandatory
  381.                DESCRIPTION
  382.                          "IPCP information for a particular PPP link."
  383.                INDEX     { ifIndex }
  384.                ::= { pppIpConfigTable 1 }
  385.  
  386.  
  387.           PppIpConfigEntry ::= SEQUENCE {
  388.                pppIpConfigAdminStatus
  389.                     INTEGER,
  390.                pppIpConfigCompression
  391.  
  392.  
  393.  
  394. Kastenholz                                                      [Page 7]
  395.  
  396. RFC 1473                       PPP/IP MIB                      June 1993
  397.  
  398.  
  399.                     INTEGER
  400.           }
  401.  
  402.           pppIpConfigAdminStatus   OBJECT-TYPE
  403.                SYNTAX    INTEGER {open(1), close(2)}
  404.                ACCESS    read-write
  405.                STATUS    mandatory
  406.                DESCRIPTION
  407.                          "The immediate desired status of the IP network
  408.                          protocol. Setting this object to open will
  409.                          inject an administrative open event into the IP
  410.                          network protocol's finite state machine.
  411.                          Setting this object to close will inject an
  412.                          administrative close event into the IP network
  413.                          protocol's finite state machine."
  414.                ::= { pppIpConfigEntry 1 }
  415.  
  416.  
  417.           pppIpConfigCompression   OBJECT-TYPE
  418.                SYNTAX    INTEGER {
  419.                          none(1),
  420.                          vj-tcp(2)
  421.                     }
  422.                ACCESS    read-write
  423.                STATUS    mandatory
  424.                DESCRIPTION
  425.                          "If none(1) then the local node will not
  426.                          attempt to negotiate any IP Compression option.
  427.                          Otherwise, the local node will attempt to
  428.                          negotiate compression mode indicated by the
  429.                          enumerated value. Changing this object will
  430.                          have effect when the link is next restarted."
  431.                REFERENCE
  432.                          "Section 4.0, Van Jacobson TCP/IP Header
  433.                          Compression of RFC1332."
  434.                DEFVAL    { none }
  435.                ::= { pppIpConfigEntry 2 }
  436.  
  437.  
  438.           END
  439.  
  440. 5.  Acknowledgements
  441.  
  442.    This document was produced by the PPP working group.  In addition to
  443.    the working group, the author wishes to thank the following
  444.    individuals for their comments and contributions:
  445.  
  446.           Bill Simpson -- Daydreamer
  447.  
  448.  
  449.  
  450. Kastenholz                                                      [Page 8]
  451.  
  452. RFC 1473                       PPP/IP MIB                      June 1993
  453.  
  454.  
  455.           Glenn McGregor -- Merit
  456.           Jesse Walker -- DEC
  457.           Chris Gunner -- DEC
  458.  
  459. 6.  Security Considerations
  460.  
  461.    The PPP MIB affords the network operator the ability to configure and
  462.    control the PPP links of a particular system, including the PPP
  463.    authentication protocols. This represents a security risk.
  464.  
  465.    These risks are addressed in the following manners:
  466.  
  467.       (1)  All variables which represent a significant security risk
  468.            are placed in separate, optional, MIB Groups. As the MIB
  469.            Group is the quantum of implementation within a MIB, the
  470.            implementor of the MIB may elect not to implement these
  471.            groups.
  472.  
  473.       (2)  The implementor may choose to implement the variables
  474.            which present a security risk so that they may not be
  475.            written, i.e., the variables are READ-ONLY. This method
  476.            still presents a security risk, and is not recommended,
  477.            in that the variables, specifically the PPP
  478.            Authentication Protocols' variables, may be easily read.
  479.  
  480.       (3)  Using SNMPv2, the operator can place the variables into
  481.            MIB views which are protected in that the parties which
  482.            have access to those MIB views use authentication and
  483.            privacy protocols, or the operator may elect to make
  484.            these views not accessible to any party.  In order to
  485.            facilitate this placement, all security-related variables
  486.            are placed in separate MIB Tables. This eases the
  487.            identification of the necessary MIB View Subtree.
  488.  
  489. 7.  References
  490.  
  491.    [1] Rose M., and K. McCloghrie, "Structure and Identification of
  492.        Management Information for TCP/IP-based internets", STD 16, RFC
  493.        1155, Performance Systems International, Hughes LAN Systems, May
  494.        1990.
  495.  
  496.    [2] McCloghrie K., and M. Rose, Editors, "Management Information Base
  497.        for Network Management of TCP/IP-based internets", STD 17, RFC
  498.        1213, Performance Systems International, March 1991.
  499.  
  500.    [3] Information processing systems - Open Systems Interconnection -
  501.        Specification of Abstract Syntax Notation One (ASN.1),
  502.        International Organization for Standardization, International
  503.  
  504.  
  505.  
  506. Kastenholz                                                      [Page 9]
  507.  
  508. RFC 1473                       PPP/IP MIB                      June 1993
  509.  
  510.  
  511.        Standard 8824, December 1987.
  512.  
  513.    [4] Information processing systems - Open Systems Interconnection -
  514.        Specification of Basic Encoding Rules for Abstract Notation One
  515.        (ASN.1), International Organization for Standardization,
  516.        International Standard 8825, December 1987.
  517.  
  518.    [5] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  519.        STD 16, RFC 1212, Performance Systems International, Hughes LAN
  520.        Systems, March 1991.
  521.  
  522.    [6] Rose, M., Editor, "A Convention for Defining Traps for use with
  523.        the SNMP", RFC 1215, Performance Systems International, March
  524.        1991.
  525.  
  526.    [7] McCloghrie, K., "Extensions to the Generic-Interface MIB", RFC
  527.        1229, Hughes LAN Systems, Inc., May 1991.
  528.  
  529.    [8] Simpson, W., "The Point-to-Point Protocol for the Transmission of
  530.        Multi-protocol Datagrams over Point-to-Point Links, RFC 1331,
  531.        Daydreamer, May 1992.
  532.  
  533.    [9] McGregor, G., "The PPP Internet Protocol Control Protocol", RFC
  534.        1332, Merit, May 1992.
  535.  
  536.   [10] Baker, F., "Point-to-Point Protocol Extensions for Bridging", RFC
  537.        1220, ACC, April 1991.
  538.  
  539.   [11] Lloyd, B., and W. Simpson, "PPP Authentication Protocols", RFC
  540.        1334, L&A, Daydreamer, October 1992.
  541.  
  542.   [12] Simpson, W., "PPP Link Quality Monitoring", RFC 1333, Daydreamer,
  543.        May 1992.
  544.  
  545. 8.  Author's Address
  546.  
  547.    Frank Kastenholz
  548.    FTP Software, Inc.
  549.    2 High Street
  550.    North Andover, Mass 01845 USA
  551.  
  552.    Phone: (508) 685-4000
  553.    EMail: kasten@ftp.com
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562. Kastenholz                                                     [Page 10]
  563.